home *** CD-ROM | disk | FTP | other *** search
/ APDL Eductation Resources / APDL Eductation Resources.iso / programs / electronic / rlab / !RLaB / !Help < prev    next >
Encoding:
Text File  |  1995-10-17  |  8.6 KB  |  221 lines
  1. ARCH:
  2.     This is RLaB for RISC OS, 1.19b, RISC OS beta 3.
  3.     As far as I know, it runs up for the title of 'Fattest RISC OS program'
  4.     since it is > 1.4M in size. No, won't run on a 2Mb machine :-).
  5.  
  6.     The port of RLaB to the RISC OS environment has been undertaken to provide
  7.     RISC OS with a powerful math tool. Not all the features of RISC OS are 
  8.     exploited .
  9.  
  10.     I suggest that you run RLaB in a !Zap Taskwindow, since I can't tell how well
  11.     do other task windows cope with it. !Edit is fine, though.
  12.  
  13.         There is no command line editing at the moment, but !Zap's select and past
  14.         is quite useful. A 'readline' type interface is planned for the future.
  15.         
  16.         Starting from version beta3, draw files are supported as output format, 
  17.         so there should be no need for Riscript/GNUPlot anymore 
  18.         
  19.         However, GNUPlot can now be used with ease as output device since I've
  20.         rewritten the 'gnuplot' 'R' file.
  21.         
  22.     The RISC OS version is likely to be included in the mainstream RLaB source code, 
  23.     so I expect to keep it quite up-to-date. (RLaB is now 1.19b)       
  24.  
  25.  
  26. ****    WHAT'S NEW: ( HEY , I SAID NEW , AND IT'S FREE : READ THIS !!!! )
  27.     
  28.     1.19b beta 3: *much* functionality included!
  29.     
  30.     A lot of popular requests for these 2 additions:
  31.     
  32.     -- Draw files supported! Just hit return when asked for the output device of
  33.     your choice. * NOTE *: most examples do not close the output stream, use pend()
  34.     or pclose() to do so or else the last plotted file will remain open.
  35.     Many thanks to Gareth McCaughan (gjm11@pmms.cam.ac.uk) for his mkdrawf 
  36.     utility that allowed me to debug draw files in a human-intelligible way.
  37.     mkdrawf files are available as output option 2 but are not supported.
  38.     (This also means that the plplot library now supports Draw files and that I'm going
  39.     to release it as well.)
  40.     
  41.     -- Help files can now be split on more than 1 directory (workaround for
  42.     77 file limit)
  43.     
  44.     -- New RISC OS specific 'gnuplot' 'R' file should anyoune need it.
  45.     
  46.     -Some bugs fixed:
  47.      1 - Quite nasty - having the 'gnuplot' R file in the lib directory would
  48.          clash with plplot. Now 'gnuplot' has been removed from the library
  49.          'rlib' directory. 
  50.          It can be found in the 'examples' dir. If you still want to use GNUPlot,  
  51.              GNUPlot 3.4 is now supported through the gnupipe utility. Remove 
  52.              'plplot' from 'rlib' and copy 'gnuplot' in it instead.
  53.          Most examples behave as they should, now!
  54.          
  55.      2 - Now differentiates from 'not existing' and 'wrong filetype' when an error
  56.          occurs while loading.
  57.     
  58.     1.19b beta 2:
  59.         
  60.         -- RLaB updated to current version, 1.19b. See WHATS/NEW for RLaB specific
  61.         info on the differences between 1.18 and 1.19
  62.  
  63.     -- New RLaB / RLaB filetype icons :-) 
  64.  
  65.     -- filetypes:
  66.     RLaB now supports filetype checking, i.e. it will check the filetype 
  67.     of any 'r' file you try to load/rfile/require and generally try to interpret.
  68.     Unless the system variable  RLAB_FILETYPE is set to something appropriate
  69.     (RLaB seems to be a reasonable filetype name), RLaB will default its type
  70.     to text and will refuse to load any other types. Unfortunately, Acorn is
  71.     running short of types, so I cannot have one allocated officially.
  72.     The PD unofficially allocated type is RLaB = 0x110
  73.     Check the !boot and !run files to see how it works.
  74.     
  75.     -- gnuplot support:
  76.     Thanks to some code provided by Alun Jones I have included the 'gnupipe' 
  77.     utility. It simply pipes to GNUPlot anything you give it. 
  78.     For example: gnupipe <list of commands>.
  79.  
  80.         -- fixed docs:
  81.         The supplied primer pages are converted by DVIView and need some TeX fonts
  82.         to be installed. A !Othrfnt directory is now supplied that should contain 
  83.         all the fonts needed
  84.  
  85.         
  86.     -- new rfiles:
  87.     loaddir:
  88.      old loaddir as supplied won't work under RISC OS. A RISC OS specific
  89.      version supersedes the old one (moved now to loaddir_ux)
  90.      (courtesy Ian McLoughlin)
  91.     gnupl_pipe:
  92.      pipes a command file to gnuplot (that must be already running)
  93.      See under gnuplot support
  94.     system_ext:
  95.      forks a task obey basically working nicely around the 'system' memory
  96.      problem. It is just an example that gives you an idea, in the 
  97.      'examples' directory
  98.         
  99.     1.18c beta 1: 
  100.     
  101.     first official release
  102.     Thanks to the new excellent Acorn C compiler v5 it can now extend its
  103.     own wimpslot so it doesn't really matter if you allocate it a smaller than
  104.     necessary chunk. Start it in a 2 Mb slot, and it will grab/release what it
  105.     needs.
  106.  
  107.  
  108. ****    OK, BUT LET ME HAVE FUN FIRST...
  109.     start !RLaB and type:
  110.     load ("test") - this should finish in approx 230 sec unless you have a math
  111.             copro (on a RPC, in a window) - It's 150 sec outside the desktop
  112.             It's 170 sec with a RPC 700 (grrr..:-) )
  113.             - how long will it take with a math copro?? 
  114.     load ("examples.plot_test") - this will create draw files and show them in 
  115.     all their glory.
  116.     load ("examples.fourier") - a nice drawing example
  117.     if you want to test GNUPlot:
  118.     Load GNUPlot
  119.     substitute plplot in 'rlib' with gnuplot (from the RISC OS dir)
  120.     start RLaB and load ("RISC_OS.gnpltst_sm")
  121.     If all goes OK, you can now proceed on your own
  122.  
  123.  
  124.  
  125. ****    KNOWN BUGS/FEATURES :-):
  126.     
  127.     beta 3:
  128.     - the plplot library fails its test #19 and does not map correctly to phisycal 
  129.     coordinates (plplot test #10). This should not be a problem for RLaB.
  130.     - I've seen RLaB crash once when I selected a filename > 10 chars for plplot
  131.     output. This may have been fixed by some changes I did.
  132.     - Always use pend() at the end of your plotting to close the last output file.
  133.       This is not a bug - It's an RLaB feature.  
  134.         - RLaB might die with a backtrace when quit, if a plotting session was
  135.           interrupted. Since however this might happen only when closing RLaB, it's
  136.           only a cosmetic issue.
  137.         - I've not had time to change the gnuplot 'r' file so that it wipes its
  138.           temp files - they are named 'rtmpf*' and you might want to remove them 
  139.           manually or edit the RISC OS gnuplot 'r' file to fix this.
  140.     
  141.     -Most of the examples files are now run without any problems.
  142.     Do not rely on the examples tough - they are providing just an example.
  143.     
  144.     -system() will not work if there is no extra space left in RLaB's wimpslot
  145.     and you try to run a compiled program. You should use this trick:
  146.     1)system("taskwindow \"<your command here>\" -quit");
  147.     
  148.     -some UNIX specific features might not be working.
  149.     
  150.     -Many more, of the worst possible kind. I just haven't discovered them yet.
  151.     Expect it to fall over at any time :-). Can't be worse than Windows anyway.
  152.     
  153. ****    CREDITS
  154.     
  155.     First of all, the 2 most patient persons in the world, my wife and daughter - 
  156.     They seldom complain whan I stay up at night debugging this beast :-) 
  157.     (mmmhh.. she just read this and suggested to change 'seldom' to 'never')
  158.  
  159.     Jan Searle (jans@eskimo.com) - The man behind RLaB. Great Job!!
  160.  
  161.     Dr. Maurice LeBrun (mjl@dino.ph.utexas.edu) - PlPlot, a superb library
  162.     
  163.         PLease read the ANNOUNCEMENT for an updated list of credits
  164.         
  165.     
  166. ****    CONTACTS:
  167.     Ian Searle (RLaB maintainer and helmsman): ians@eskimo.com
  168.         for RLaB bugs only - check with me first to see if it's an Acorn problem
  169.     
  170.     Maurizio Ferrari (Acorn port responsible): ferrari@bologna.maraut.it
  171.         RLaB Acorn port problems
  172.         Mail me to be included in the 'updates for RISC OS' mailing list.
  173.         
  174.     RLaB mailing list: Send mail to rlab-request@eskimo.com
  175.                 This is read by a human, so no special syntax is required, just state 
  176.                 your desire.
  177.         To communicate with others on the list mail to rlab-list@eskimo.com
  178.  
  179.  
  180. ****    HISTORY:
  181.  
  182.         1.19b beta 3
  183.         Drawfiles native
  184.         Split help dir
  185.         GNUPlot real support
  186.  
  187.     1.19b beta 2
  188.     RLaB updated to 1.19b
  189.     
  190.     1.18c beta 2 - never publicly released
  191.     Filetype check on loads/rfile/require etc. 
  192.            It defaults to text unless otherwise specified.
  193.     New startup taskobey (Now displays name in task list)
  194.     rfiles: loaddir, gnupl_pipe
  195.     
  196.     1.18c beta 1
  197.     Switched to AnsiLib and C v5
  198.     Improvements:
  199.         1-Dynamic allocations of WimpSlot (thanks to Acorn C v5)
  200.         2-Now loads files with '/' in the name string (couldn't with Unixlib)
  201.         3-Fixed Infinity and Nan representation
  202.     
  203.     1.18c alpha - never publicly released
  204.     Never released, first fully functional version. Compiled with Unixlib and Acorn C v4
  205.  
  206.  
  207. ****    FUTURE IMPROVEMENTS:
  208.     
  209.     Add a readline type interface
  210.     Throwback on rfiles syntax errors
  211.     Better integration in the Desktop (nice menus, iconbar, drag, drop, AND A BANNER!)
  212.     
  213.     
  214.     PPLLLLEEEEEEAAAAAASSSSEEEEEEEEEEEE!!!!!!!!!!
  215.     
  216.     I need feedback - It took me quite a long time to port RLaB. Tell me what you think
  217.     and give advice for future enhancements. You can even send me a tin of anchovies
  218.     I like them on a slice of pizza.
  219.     
  220.     IF YOU HAVE READ SO FAR YOU ARE AN ASTOUNDING READER :-)
  221.